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RSTS/E DOCUMENTATION DIRECTORY 


RSTS/E software consists of distribution media and documentation. 
The documentation describes the components and operation of the 
RSTS/E software. This directory describes the RSTS/E documentation. 


1.0 ORGANIZATION OF THE DOCUMENT SET 


The RSTS/E document set is logically divided into 5 categories, as 
follows: 


system reference 

system procedures 

system management and maintenance 
languages 

optional software 


Table 1 lists the manuals by category and indicates the intended 
audience of each manual. 


Table 1 
RSTS/E Documentation Set 


|__| Audience 
Category Document ystem system 
Title Manager |Programmer | 

System RSTS/E Document X X 
Reference Directory ; 

RSTS/E Programming Xx 

Manual 

RSTS/E System xX xX 

Generation 

Manual 


RSTS/E System 
Manager's Guide 


System 
Procedures 


RSTS-11 System 
User's Guide 


RSTS/E RUNOFF 
User's Guide 


DOS/BATCH Text 
Editor (EDIT) 
Programmer's 
Manual 


PDP-11 ROLLIN 
Utility 

Programmer's 
Manual 


System System Xx x 
Management Generation 

and Manual 

Maintenance 


RSTS/E System xX xX’ | 
Installation 
Notes | | 


RSTS/E System 
Reliability 
Test 


RSTS/E System 
Manager's Guide 


General 
User 


Table 1 (Cont.) 
RSTS/E Documentation Set 
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Document System System General 
Category Title Manager Programmer User 


Languages BASIC-PLUS 
os 
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PDP-11 COBOL xX X 
Language 

Reference 

Manual 


PDP-11 COBOL X Xx 
User's Guide 


PDP-11 COBOL X Xx 
Language 

Reference 

Card 


Optional PDP-11 SORT 
Software User's Guide 


RSTS/E 
Commercial 
User's Guide 


RSTS/E 2780 
User's Guide 


RSTS-11 Sort 
User's Guide 


2.0 DOCUMENT DESCRIPTION 


The following paragraphs summarize the information contained in each 
manual in the document set. The first four documents are listed in 
the recommended reading order for the system manager. The remaining 


documents can be read in any order that is suitable to one's interests. 


RSTS/E System Generation Manual 
RSTS/E System Installation Notes 
RSTS/E System Reliability Test 
RSTS/E System Manager's Guide 
RSTS-11 System User's Guide 
BASIC-PLUS Language Manual 
RSTS/E Programming Manual 

RSTS/E RUNOFF User's Guide 
DOS/BATCH Edit 

PDP-11 ROLLIN 

PDP-11 COBOL Language Reference Manual 
PDP-11 COBOL User's Guide 

PDP-11 COBOL Reference Card 
PDP-11 SORT User's Guide 

RSTS/E Commercial User's Guide 
RSTS/E 2780 User's Guide 

RSTS-11 Sort User's Guide 


2.1 RSTS/E System Generation Manual (DEC-11-ORGNA-A-D) 


This manual describes the complete procedures to generate the V06A-02 
RSTS/E system image, initialize system structures, and build the system 
library. Also included are procedures to build optional RSTS/2780 

and PDP-11 COBOL software. Because RSTS/E supports a variety of hard- 
ware and offers many optional software features, the manual also contains 
reference information useful for planning and maintaining the system. 
Especially important are the system initialization options. They are 
used both to optimize system structures and to maintain and restructure 


the system. 


2.2 RSTS/E System Installation Notes (DEC-11-ORINB-C-D) 


This document contains system code and library code patches and hard- 
ware and software installation guidelines related to the version of 
RSTS/E. The information is required for generating RSTS/E. 


2.3 RSTS/E System Reliability Test (DEC-11-ORSRB-B-D) 


This document describes the procedures to build system test files and 


run device exerciser programs. The document is designed to be used 


with the RSTS/E System Generation Manual. 


The system test procedures are followed after a new RSTS/E system is 
generated or can be used later to isolate hardware or system software 


malfunctions. 
2.4 RSTS/E System Manager's Guide (DEC-11-ORSMD-A-D) 


This guide is directed to the individual who administrates and controls 
the local installation. It contains information on utilization of 
hardware and software resources. The material is more detailed than 
that presented in the RSTS/1l1 System User's Guide and is directed more 
at the privileged user than at the non-privileged user. Also included 
are the operational procedures necessary to daily functioning of the 
system. Included are guidelines for controlling system start up, 

shut down, and job execution; procedures for creating accounts and pro- 
ducing account statistics; procedures for queue management and spooling, 
for system error detection and correction; and for system utility opera- 
tions such as disk management, run time system control, system statis- 


tics, terminal characteristics, and optimizing disk directories. 


2.5 RSTS-11 System User's Guide (DEC-11-ORSUA-D-D) 


This guide is directed at the time sharing user. Information on 
system commands and system programs is provided. Most functions 
described are non-privileged and the materiai is general in nature. 


Also included are device operating procedures. 


2.6 BASIC-PLUS Language Manual (DEC-11-ORBPB~A-D) 


This manual introduces the beginning user to the more elementary 
parts of the BASIC-PLUS language and explains for the experienced 
user the more advanced features of BASIC-PLUS as implemented in 
Version V6A of RSTS/E. Procedures are explained to help a user debug 
a program and to write more advanced code. The more commonly used 
system functions are described along with the three forms of input/ 
output available: formatted ASCII, virtual core, and Record I/O. 


The manual is a complement of the RSTS/E Programming Manual. 


2.7  RSTS/E Programming Manual (DEC-11-ORPMA~A-D) 


This manual presents device dependent features and more complex system 
function descriptions for the advanced programmer who uses RSTS/E 
VO6A. Both file structured and non-file structured operations are 
described for disk, magnetic tape, paper tape, terminals, and line 
printers. The system function calls to monitor are defined and 


programming conventions explained. 
2.8 RSTS/E RUNOFF User's Guide (DEC-11-URUNA-B-D) 


This guide presents operating and preparation information for the 
RSTS/E VO6A text formatting system program RUNOFF. The manual 
describes RUNOFF commands and their effect in the output text and shows 
how to produce a formatted output file. 


2.9 DOS/BATCH Text Editor (EDIT) Programmer's Manual (DEC-11-UEDAA-A-D) 


This manual describes file creation, editing and manipulating pro- 
cedures for the EDIT-1l program which is compatible with the RSTS/E 
EDIT system program. The commands and operating procedures are defined 
in this manual and summarized in the RSTS-11 System User's Guide for 
EDIT. 


2.10 PDP-11 ROLLIN Utility Programmer's Manual (DEC-11]1-OROAA-B-D) 
This manual describes the commands and operating procedures for 


making image mode copies of disks or for transferring images to 
and from tape using the stand alone program ROLLIN. 


2.11 PDpP-11 COBOL Language Reference Manual! (DEC-11-LCOBA-B-D) 


This manual describes the COBOL Language elements as implemented on 
the PDP-ll. It is based on the document American National Standard 
COBOL, X3.23 - 1974, both for organization and content. Descriptions 
of PDP-1l extensions to the standard language are shaded. 


2.12 PDP-11 COBOL User's Guide! (DEC-11-LCUGA-A-D) 


This guide is a companion document to the PDP-11 COBOL Language 
Reference Manual. It contains additional information on the compiler, 
the run time system utility programs and a complete list of COBOL 
error messages. 


2.13 PDP-11 COBOL Reference Card! (DEC-11-LCRCA-A-D) 


The card is a handy pocket reference containing the COBOL statement 
formats, a list of the compiler-reserved words, constants, picture 
symbols, and an ASCII code chart. 


! 


2.14 PDP-11 SORT Reference Manual! (DEC-11-USTMA-A-D) 


This manual describes the features and operation of the PDP-11 SORT 
program distributed with the COBOL compiler and object time system. 


2.15 RSTS/E Commercial User's Guide! (DEC-11-ORCUA-A-D) 


This guide describes generation and operation of the RSTS/E Indexed 
Access Method (IAM) and the commercial QUE and LPSPL programs. Also 
described is the decimal 4-word arithmetic package. 


2.16 RSTS-11 Sort User's Guide (DEC-ORSGA-A-D) 


This guide describes the generation and operation of the RSTS-11 Sort 
programs distributed with the RSTS/E Commercial User's package. The 

Sort programs are coded in BASIC-PLUS and stored in the system library 
as compiled (BAC) files. Also included in the guide are file formats, 
error messages, program interfaces, key extraction technique, and the 


use of the key file dump utility. 


‘Available under separate license. 


2.17 RSTS/E 2780 User's Guide (DEC-11-ORJEA-A-D) 


This guide describes the operation of the RJ2780 program for users 

of RSTS/E systems with the RSTS/2780 software package. Included are 
a summary of the build procedures, a list of hardware and software 
options, and the steps required to send data to and receive data from 
a remote computer system. Features related to the 2780 environment 


are described in the document 2780 Remote Computer Systems Installation 


Notes. 


HOW TO OBTAIN SOFTWARE INFORMATION 


SOFTWARE NEWSLETTERS, MAILING LIST 


The Software Communications Group, located at corporate headquarters in 
Maynard, publishes software newsletters for the various DIGITAL products. 
Newsletters are published monthly, and keep the user informed about cus- 
tomer software problems and solutions, new software products, documenta- 
tion corrections, as well as programming notes and techniques. 


There are two Similar levels of service: 


‘ The Software Dispatch 
‘ The Digital Software News 


The Software Dispatch is part of the Software Maintenance Service. fThis 
service applies to the following software products: 


PDP-9/15 
RSX-11D 

DOS /BATCH 
RSTS/E 
DECsystem-10 


A Digital Software News for the PDP-1l and a Digital Software News for 
the PDP-8/12 are available to any customer who has purchased PDP-11 or 
PDP-8/12 software. 


A collection of existing problems and solutions for a given software 
system is published periodically. A customer receives this publication 
with his initial software kit with the delivery of his system. This 
collection would be either a Software Dispatch Review or Software Per- 
formance Summary depending on the system ordered. 


A mailing list of users who receive software newsletters is also main- 
tained by Software Communications. Users must sign-up for the news- 
letter they desire. This can be done by either completing the form sup- 
plied with the Review or Summary or by writing to: 


Software Communications 
P.O. Box F 
Maynard, Massachusetts 01754 


SOFTWARE PROBLEMS 


Questions or problems relating to DIGITAL's software should be reported 
as follows: 


North and South American Submitters: 


Upon completion of Software Performance Report (SPR) form remove last 
copy and send remainder to: 


Software Communications 
P.O. Box F 
Maynard, Massachusetts 01754 


The acknowledgement copy will be returned along with a blank SPR form 
upon receipt. The acknowledgement will contain a DIGITAL assigned SPR 
number. The SPR number or the preprinted number should be referenced in 
any future correspondence. Additional SPR forms may be obtained from 
the above address. 


All International Submitters: 


Upon completion of the SPR form, reserve the last copy and send the re- 
mainder to.-the SPR Center.in the nearest DIGITAL. office. SPR forms are 
also available from our SPR Centers. 


PROGRAMS AND MANUALS 


Software and manuals should be ordered by title and order number. In the 
United States, send orders to the nearest distribution center. 


Digital Equipment Corporation Digital Equipment Corporation 


Software Distribution Center Software Distribution Center 
146 Main Street 1400 Terra Bella 
Maynard, Massachusetts 01754 Mountain View, California 94043 


Outside of the United States, orders should be directed to the nearest 
Digital Field Sales Office or representative. 


USERS SOCIETY 


DECUS, Digital Equipment Computers Users Society, maintains a user ex- 
change center for user-written programs and technical application infor- 
mation. The Library contains approximately 1,900 programs for all 
DIGITAL computer lines. Executive routines, editors, debuggers, special 
functions, games, maintenance and various other classes of programs are 
available. 


DECUS Program Library Catalogs are routinely updated and contain lists 
and abstracts of all programs according to computer line: 


° PDP-8, FOCAL-8, BASIC-8, PDP-12 
. PDP-7/9, 9, 15 

. PDP-11, RSTS-11 

° PDP-6/10, 10 


Forms and information on acquiring and submitting programs to the DECUS 
Library may be obtained from the DECUS office. 


In addition to the catalogs, DECUS also publishes the following: 


DECUSCOPE ~The Society's technical newsletter, published bi-monthly, 
aimed at facilitating the interchange of technical in- 
formation among users of DIGITAL computers and at dis- 
seminating news items concerning the Society. Circula- 
tion reached 19,000 in May, 1974. 


PROCEEDINGS OF -Contains technical papers presented at DECUS Symposia 


THE DIGITAL held twice a year in the United States, once a year 
EQUIPMENT USERS in Europe, Australia, and Canada. 

SOCIETY 

MINUTES OF THE ~A report of the DECsystem-10 sessions held at the two 
DECsystem-10 United States DECUS Symposia. 

SESSIONS 

COPY-N-Mail -A monthly mailed communique among DECsystem-10 users. 
LUG/SIG -Mailing of Local User Group (LUG) and Special Interest 


Group (SIG) communique, aimed at providing closer 
communication among users of a specific product or 
application. 


Further information on the DECUS Library, publications, and other DECUS 
activities is available from the DECUS offices listed below: 


DECUS DECUS EUROPE 

Digital Equipment Corporation Digital Equipment Corp. International 
146 Main Street (Europe) 

Maynard, Massachusetts 01754 P.O. Box 340 


1211 Geneva 26 
Switzerland 
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READER'S COMMENTS 


a 


NOTE: This form is for document comments only. Problems 
with software should be reported on a Software 
Problem Repert (SPR) form (see the HOW TO OBTAIN 
SOFTWARE INFORMATION page). 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


a 


Please indicate the type of user/reader that you most nearly represent. 


Assembly language programmer 
Higher-level language programmer 
Occasional programmer (experienced) 
User with little programming experience 
Student programmer 


OOOO000 


Name __ Date 
Organization 
Street 
CR yt State Ip Code 
or 
Country 
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Non-programmer interested in computer concepts and capabilities 
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